Summary
Creates a button or link that opens a new window and loads the document specified by a given URL.
Category | AS Document |
Version | 1.0 |
Complies with Xhtml 1.0 / 1.1 rules | Yes |
Supported server programming languages | C# Visual Basic.NET |
Output content type | inline |
When to use
This component is typically used when there is a need to open a new browser window with the content of a specific Url.
Programming interface
Parameters
- Label
- Label for button/link
- Link
- Creates a link
- Button
- Creates a button
- Class
- Class for button/link
- ID
- ID for the document to display.
- PTID
- Optional presentation template ID.
- Size and positioning
- Height
- Specifies the height of the window, in pixels. The minimum value is 100.
- Width
- Sets the width of the window, in pixels. The minimum value is 100.
- Top
- Specifies the top position, in pixels. This value is relative to the upper-left corner of the screen.
- Left
- Specifies the left position, in pixels. This value is relative to the upper-left corner of the screen.
- Options
- Channel mode
- Specifies whether to display the window in theater mode and show the channel band. The default is no.
- Directory buttons
- Specifies whether to add directory buttons. The default is yes.
- Fullscreen
- Specifies whether to display the browser in full-screen mode. The default is no. Use full-screen mode carefully. Because this mode hides the browsers title bar and menus, you should always provide a button or other visual clue to help the user close the window. ALT+F4 closes the new window.
- Location field
- Specifies whether to display the input field for entering URLs directly into the browser. The default is yes.
- Menu bar
- Specifies whether to display the menu bar. The default is yes.
- Resizable
- Specifies whether to display resize handles at the corners of the window. The default is yes.
- Scrollbars
- Specifies whether to display horizontal and vertical scroll bars. The default is yes.
- Status bar
- Specifies whether to add a status bar at the bottom of the window. The default is yes.
- Title bar
- Specifies whether to display a title bar for the window. This parameter is ignored unless the calling application is an HTML Application or a trusted dialog box. The default is yes.
- Tool bar
- Specifies whether to display the browser toolbar, making buttons such as Back, Forward, and Stop available. The default is yes.
- Replace entry in history list
- Optional. When the sURL is loaded into the same window, this Boolean parameter specifies whether the sURL creates a new entry or replaces the current entry in the windows history list.
- Name
- Optional. String that specifies the name of the window. This name is used as the value for the TARGET attribute on a form or an a element.
-
- Common values are:
- _blank
The url is loaded into a new, unnamed window. - _parent
The sURL is loaded into the current frames parent. If the frame has no parent, this value acts as the value _self. - _search
Available in Microsoft® Internet Explorer 5 and later. The sURL is opened in the browser's search pane. - _self
The current document is replaced with the specified sURL - _top
sURL replaces any framesets that may be loaded. If there are no framesets defined, this value acts as the value _self.
Remarks
---